home *** CD-ROM | disk | FTP | other *** search
/ Gigantic Games 2 / Gigantic Games 2.iso / pc / _m_ / madgic / new for 4.1 < prev    next >
Text File  |  1994-12-23  |  7KB  |  158 lines
  1. Here are just some of the things new for version 4.1 of The MADgic Core:
  2.  
  3. ASR
  4. ---
  5.  
  6.    Multiple file assembly -
  7.       By far the biggest new feature for 4.1 is the ability to assemble
  8.       multiple files with a single invocation of ASR.  From the WorkBench,
  9.       you SHIFT-Select multiple source files while starting up ASR.  ASR
  10.       will issue a report on each individual file as it is assembled as
  11.       well as list the number of successful and failed assemblies at the
  12.       end of execution.  This will work even across volumes (different
  13.       disks).
  14.  
  15.       From the Shell, just type the command ASR followed by a simple
  16.       AmigaDOS pattern (one containing only #'s and/or ?'s).  ASR can
  17.       handle multiple directories with a single pattern.  For instance,
  18.       to assemble all of the ICWS tournament programs in each of the four
  19.       directories as they appear on The MADgic Core disk in df0:,
  20.       issue the command
  21.  
  22.          "ASR df0:#?/#?.s"
  23.  
  24.       ASR can handle even more levels (i.e. #?/#?/#?/#?.s) if necessary.
  25.       Or you can just list multiple files (i.e. "ASR file1 file2 etc.").
  26.  
  27.       This feature has allowed the deletion of all of the object files from
  28.       the tournament program directories to make room for other improvents.
  29.  
  30.    ToolTypes -
  31.       ASR recognizes the following Tooltypes field of the ASR icon set
  32.       using the WorkBench menu Info command.  They are:
  33.  
  34.          WINDOW=<left>/<top>/<width>/<height> where <left> is the left edge
  35.             of the assembly window, <top> is the top edge, <width> is the
  36.             <width>, and <height> is the height (in pixels).  Some
  37.             combinations may not be available and could possibly result in
  38.             a crash.
  39.          NOCOMMAS=<TrueOrFalse> where <TrueOrFalse> is either TRUE or FALSE.
  40.             NOCOMMAS=TRUE tells the assembler not to expect commas between
  41.             operands.  If this option is set, operands are separated by
  42.             whitespace and therefore no whitespace can occur with operand
  43.             expressions.  Ordinarily ASR can determine whether operands
  44.             are separated by whitespace or not, but some instructions can
  45.             be ambiguous.  Example: DAT 2 -1  (Is it "DAT (2-1)" or is it
  46.             "DAT 2, -1"?).
  47.          NOICONS=<TrueOrFalse> where NOICONS=TRUE keeps ASR from saving
  48.             .info files along with the object files.
  49.          DISPLAY=<TrueOrFalse> where DISPLAY=TRUE will list the assembly
  50.             to the window.
  51.          PRINT=<TrueOrFalse> where PRINT=TRUE will list the assembly to the
  52.             PRT: device.
  53.          VERSION=<version> where <version> is 86 for ICWS'86 and 88 is for
  54.             ICWS'88.  The fields for SPL were swapped between ICWS'86 and
  55.             ICWS'88.  This option tells the assembler how to assemble
  56.             instructions like "SPL 0".  The default is ICWS'88.  Only MARS
  57.             truly supports the ICWS'86 style assembly.  SmallMARS and
  58.             FastMARS really expect an ICWS'88 assembly, but otherwise
  59.             behave as ICWS'86 rules dictate.  There is no way for you to
  60.             know whether an object file was assembled as ICWS'86 or ICWS'88,
  61.             so I recommend you use this option only if you absolutely have
  62.             to do so.
  63.  
  64.    Command line options -
  65.       ASR supports many command line options from the Shell.  They are:
  66.  
  67.          -c    Same as NOCOMMAS=TRUE above.
  68.          -i    Same as NOICONS=TRUE above.
  69.          -l    Same as DISPLAY=TRUE above.
  70.          -v86  Same as VERSION=86 above.
  71.          -v88  Same as VERSION=88 above (the default).
  72.  
  73.       There are AmigaDOS style options which fulfill the same functions as
  74.       the above.  Here is the template for the ASR command:
  75.  
  76.          FILES/A/M,D=DISPLAY/S,P=PRINT,NC=NOCOMMAS/S,NI=NOICONS/S:
  77.  
  78.  
  79. MARS
  80. ----
  81.  
  82.    Preloading filenames from WorkBench -
  83.       If you SHIFT-Select one or two object file icons while starting up
  84.       MARS from the WorkBench, the filenames are preloaded into the file
  85.       requester brought up by the Load command.  You still need to issue
  86.       the Load command to actually load the programs.  What is new for 4.1
  87.       is that you can preload the file requester across volumes (disks).
  88.  
  89.    ToolTypes -
  90.       You can set many defaults in the ToolTypes field of the MARS icon by
  91.       using the WorkBench menu Info command.  Here are the recognized tools:
  92.  
  93.          SIZE=<size> where <size> is any of the Core sizes available from
  94.             the Core menu (2000, 4000, 8000, 8192, 16000, 32000, 64000,
  95.             and 128000).
  96.          CYCLES=<maximum cycles before declaring a draw>
  97.          TASKS=<maximum number of tasks per warrior>
  98.          COLOR=<rgb>|<rgb>|<rgb>|<rgb>|<rgb>|<rgb>|<rgb>|<rgb> where each
  99.             r, g, or b is a hexidecimal number (0-F).  The default colors
  100.             are, in this order, grey, light blue, dark blue, white, black,
  101.             light red, dark red, and green.
  102.          VERSION=<version> where <version> is either 86 for the ICWS'86
  103.             standard or 88 for the ICWS'88 standard.
  104.  
  105.       New for 4.1 are:
  106.  
  107.          CPU=<cpu type> where cpu type is MEMORY for Memory-Based and
  108.             REGISTER for Register-Based.
  109.          MEMORY=<left>/<top>/<width>/<height>/<display> where <left> is
  110.             the left edge of the Memory Window, <top> the top edge,
  111.             <width> the width, and <height> is the height.  Some
  112.             combinations may not be available.  <display> is optional and
  113.             can be either ON or OFF.
  114.          TRACE=<left>/<top>/<width>/<height>/<display> where all the fields
  115.             behave the same as above.
  116.          GAUGE=<left>/<display>
  117.          TIMER=<left>/<display>
  118.          SOUND=<switch> where <switch> is either ON or OFF.
  119.  
  120.       MARS does not recognize any flags or commands from the Shell.
  121.  
  122.    Improved Style Guide Compliance -
  123.       The Load requester no longer automatically selects the first string
  124.       gadget.  Select the first gadget with the mouse or type the <TAB> or
  125.       <RETURN> keys to automatically select the first gadget.  Otherwise,
  126.       the <A>, <B>, or <R> keys will activate the A..., B..., or Random
  127.       gadgets, respectively.
  128.  
  129.       Clicking outside active requesters will result in the Wait pointer
  130.       (the 2.0 Stopwatch) being displayed.  The Wait pointer now appears
  131.       during every activity which may impede interacting with the program.
  132.  
  133.    More keyboard shortcuts -
  134.       Almost every menu command now has a keyboard equivalent with at least
  135.       a remote relationship to the command.  (There are exceptions).
  136.  
  137.    New sound features -
  138.       You can now control each warrior's sound volume individually from the
  139.       Sound requester.
  140.  
  141.    New "processor" support -
  142.       MARS now supports a Memory-Based interpretation of the standards as
  143.       well as the original (default, and correct - so say I) Register-Based
  144.       interpretation.
  145.  
  146.    New 2.0-look system gadgets -
  147.       The Trace Window and Memory Window both now have system gadgets with
  148.       2.0-look system gadgets, even under 1.x versions of the operating
  149.       system.  This is a bit of an experimental hack, and I'm not sure
  150.       whether I will keep them - or even if they will work under all
  151.       circumstances.
  152.  
  153.  
  154. Kaboom!
  155. -------
  156.    This game is shamefully copied from another platform, but still can be
  157.    a great deal of addictive fun and is included as a bonus.
  158.